================================================================================
 📸 STUDIOFLOW OS — คู่มือการติดตั้ง การใช้งาน และวิธีแก้ปัญหาที่พบบ่อย (macOS & Windows)
 (ระบบบริหารคิวงาน ออกใบจอง A4 สรุปกำไร P&L และออกใบหักภาษี 50 ทวิ สำหรับสตูดิโอถ่ายภาพ)
================================================================================

ยินดีต้อนรับสู่ StudioFlow!
คู่มือนี้ออกแบบมาให้เข้าใจง่ายที่สุด เพื่อให้คนทั่วไปสามารถติดตั้งและเริ่มใช้งานได้ทันทีภายใน 3 นาที
โดยไม่ต้องมีความรู้ด้านไอทีหรือเขียนโค้ดใดๆ ทั้งสิ้น

💡 แนะนำ: ในโฟลเดอร์เดียวกันนี้ มีไฟล์ชื่อ
👉 "📘 คู่มือการติดตั้งและแก้ปัญหา (คลิกเปิดอ่าน).html"
คุณสามารถดับเบิลคลิกเปิดอ่านแบบมีสีสันและภาพประกอบเข้าใจง่ายบนเว็บเบราว์เซอร์ได้ทันที!

--------------------------------------------------------------------------------
 ⚠️ ขั้นตอนสำคัญที่สุดก่อนเริ่ม (ห้ามข้าม!)
--------------------------------------------------------------------------------
เมื่อดาวน์โหลดไฟล์ ZIP มาแล้ว:
❌ ห้ามดับเบิลคลิกเปิดโปรแกรมจากข้างในไฟล์ .zip โดยตรง (เพราะระบบจะเซฟข้อมูลไม่ได้)
✅ ให้ "แตกไฟล์" (Extract / Unzip) ออกมาเป็นโฟลเดอร์ปกติก่อนเสมอ:
   • บน Windows: คลิกขวาที่ไฟล์ ZIP -> เลือก "Extract All..." (แยกไฟล์ทั้งหมด) -> กด Extract
   • บน macOS: ดับเบิลคลิกที่ไฟล์ .zip ระบบจะแตกออกมาเป็นโฟลเดอร์ให้อัตโนมัติ
   • แนะนำให้ย้ายโฟลเดอร์ที่แตกแล้วไปไว้ที่หน้าจอ Desktop หรือ Documents เพื่อหาง่าย

================================================================================
 🚀 1. วิธีเปิดใช้งานโปรแกรม (แยกตามระบบปฏิบัติการ)
================================================================================

--------------------------------------------------------------------------------
 🍎 สำหรับผู้ใช้เครื่อง Mac (macOS — รองรับชิป Apple M1 / M2 / M3 / M4 และ Intel)
--------------------------------------------------------------------------------
[วิธีเปิดใช้งาน]
1. เปิดโฟลเดอร์ StudioFlow ที่แตกไฟล์ออกมาแล้ว
2. มองหาไฟล์ชื่อ:
   👉 "เปิด StudioFlow (Mac).command" (หรือ "StudioFlow.app" / "START_MAC.command")
3. ดับเบิลคลิกเพื่อเปิดโปรแกรม:
   • สำหรับการเปิดครั้งแรก (เมื่อต่ออินเทอร์เน็ต): ระบบจะเตรียมตัวรันอัตโนมัติ (ใช้เวลาประมาณ 15-30 วินาที)
   • เมื่อระบบพร้อมแล้ว หน้าต่างเว็บเบราว์เซอร์ (Safari / Chrome) จะเด้งเปิดหน้าโต๊ะทำงาน
     StudioFlow ขึ้นมาให้อัตโนมัติทันที!

🔧 [วิธีแก้ปัญหาเมื่อเปิดครั้งแรกบน Mac แล้วติดแจ้งเตือนความปลอดภัย (Gatekeeper)]
หากเปิดครั้งแรกแล้ว Mac แจ้งว่า "ไม่สามารถเปิดได้เนื่องจากมาจากนักพัฒนาที่ไม่รู้จัก" หรือ "Apple could not verify":
   • วิธีแก้ที่ง่ายที่สุด (ทำแค่ครั้งแรกครั้งเดียว):
     1) กดปุ่ม Control ค้างไว้ แล้วคลิก (หรือคลิกขวา) ที่ไฟล์ "เปิด StudioFlow (Mac).command"
     2) เลือกเมนู "Open" (เปิด) จากรายการที่เด้งขึ้นมา
     3) จะมีหน้าต่างถามซ้ำ ให้กดปุ่ม "Open" (เปิด) ยืนยันอีกครั้ง
   • หากเป็น macOS Sequoia (เวอร์ชันใหม่ล่าสุด) แล้วยังไม่มีปุ่ม Open:
     1) เปิดแอป System Settings (การตั้งค่าระบบ) -> ไปที่เมนู Privacy & Security (ความเป็นส่วนตัวและความปลอดภัย)
     2) เลื่อนลงมาด้านล่างสุด จะเห็นข้อความแจ้งเตือนชื่อไฟล์ที่ถูกบล็อก -> กดปุ่ม "Open Anyway" (เปิดอยู่ดี)
     3) ใส่รหัสผ่านเครื่อง Mac ของคุณ เพียงเท่านี้ครั้งต่อไปก็ดับเบิลคลิกเปิดได้ปกติทันที!

--------------------------------------------------------------------------------
 🪟 สำหรับผู้ใช้เครื่อง Windows (Windows 10 และ Windows 11)
--------------------------------------------------------------------------------
[วิธีเปิดใช้งาน]
1. หลังจากแตกไฟล์ (Extract All) ออกมาเป็นโฟลเดอร์แล้ว ให้เปิดเข้าไปในโฟลเดอร์
2. มองหาไฟล์ชื่อ:
   👉 "เปิด StudioFlow (Windows).bat" (หรือ "START_WINDOWS.bat")
   (ข้อสังเกต: ในบางเครื่องอาจจะไม่แสดงนามสกุล .bat ให้ดูที่ชื่อ "เปิด StudioFlow (Windows)")
3. ดับเบิลคลิกที่ไฟล์นั้น:
   • จะมีหน้าต่างจอดำ (Server) เด้งขึ้นมาเพื่อรันฐานข้อมูลในเครื่อง
   • สำหรับการเปิดครั้งแรก ระบบจะตั้งค่าเริ่มต้นอัตโนมัติ (ประมาณ 15-30 วินาที)
   • จากนั้นหน้าเว็บเบราว์เซอร์ (Chrome / Edge) จะเปิดหน้าโต๊ะทำงาน StudioFlow ขึ้นมาทันที!

🔧 [วิธีแก้ปัญหาเมื่อเปิดครั้งแรกบน Windows แล้วขึ้นหน้าจอสีฟ้า (Windows Protected Your PC)]
หากเปิดครั้งแรกแล้วขึ้นหน้าต่างสีฟ้า Microsoft Defender SmartScreen:
   • วิธีแก้ (ทำแค่ครั้งแรกครั้งเดียว):
     1) คลิกที่ข้อความเล็กๆ ที่เขียนว่า "More info" (ข้อมูลเพิ่มเติม) ตรงกลางซ้ายของหน้าต่าง
     2) จะมีปุ่ม "Run anyway" (เรียกใช้ต่อไป) โผล่ขึ้นมาด้านล่าง -> ให้กดปุ่ม "Run anyway" ได้เลย
     (โปรแกรมปลอดภัย 100% เป็นเพียงการแจ้งเตือนปกติของ Windows สำหรับโปรแกรมที่รันแบบออฟไลน์)

⚠️ ข้อควรจำขณะใช้งาน (ทั้ง Mac และ Windows):
   • ขณะใช้งาน อย่าเพิ่งกดกากบาทปิดหน้าต่าง Terminal / จอดำ (ให้ย่อพับเก็บไว้ที่แถบด้านล่าง)
   • เมื่อใช้งานเสร็จและต้องการปิดโปรแกรม ให้กดปิดหน้าต่าง Terminal / จอดำ ข้อมูลทั้งหมดจะถูกเซฟลงเครื่องอัตโนมัติ

================================================================================
 📖 2. คู่มือการใช้งานเบื้องต้น 4 ขั้นตอน (เข้าใจง่ายใน 3 นาที)
================================================================================

เมื่อหน้าจอโปรแกรมเปิดขึ้นมาที่ http://localhost:8000/admin แล้ว คุณสามารถเริ่มใช้งานตามลำดับนี้ได้เลย:

[ขั้นตอนที่ 1: ตั้งค่าข้อมูลสตูดิโอของคุณ (ทำครั้งแรกครั้งเดียว)]
• คลิกปุ่ม "⚙️ ตั้งค่าระบบ" (มุมขวาบนของหน้าจอ)
• กรอกชื่อสตูดิโอ, เบอร์โทร, ลิงก์เพจ, เลขบัญชีธนาคาร/พร้อมเพย์ และอัปโหลดโลโก้สตูดิโอของคุณ
• ปรับราคาแพ็กเกจ (ภาพนิ่ง / วิดีโอ Cinema / แพ็กเกจควบ) และรายชื่อทีมงานประจำได้ตามต้องการ
• กดปุ่ม "บันทึกการตั้งค่า" ข้อมูลทั้งหมดจะไปแสดงบนหัวใบจองและใบเสร็จ A4 อัตโนมัติ

[ขั้นตอนที่ 2: บันทึกคิวงานใหม่ & ออกใบจอง 1 หน้า A4]
• ที่หน้าโต๊ะทำงานหลัก (Desk) กรอกชื่อลูกค้า เบอร์โทร เลือกวันที่จัดงาน และสถานที่
• เลือกแพ็กเกจที่ลูกค้าจอง (ระบบจะแยกสเปกภาพนิ่งและวิดีโอให้อัตโนมัติ ไม่ปนกัน)
• หากมีบริการเสริม (เช่น บินโดรน, Same Day Edit, อาฟเตอร์ปาร์ตี้) หรือค่าเดินทาง สามารถติ๊กเลือกได้เลย ระบบคำนวณยอดรวมและยอดมัดจำให้อัตโนมัติ
• แนบสลิปโอนเงินมัดจำ (ถ้ามี) แล้วกดปุ่ม "💾 บันทึกคิวงาน & ออกใบจอง"
• ระบบจะสร้าง "ใบจองคิวงาน / ใบเสร็จรับเงิน 1 หน้า A4" ที่จัดหน้าสวยงามเป๊ะ สามารถกดสั่งพิมพ์หรือบันทึกเป็นไฟล์ PDF ส่งให้ลูกค้าได้ทันที!

[ขั้นตอนที่ 3: นัดคิวทีมงานเข้ากลุ่ม LINE ในคลิกเดียว]
• ในตารางรายการคิวงาน กดปุ่ม "📋 บรีฟทีมงาน / LINE" ของคิวงานนั้น
• ระบบจะสรุปใบคิวงาน (Call Sheet) พร้อมชื่อลูกค้า เวลานัดหมาย สถานที่ พิกัด และรายชื่อตากล้อง/วิดีโอ
• กดปุ่ม "คัดลอกข้อความส่ง LINE" เพื่อนำไปวางในกลุ่ม LINE ทีมงานได้ทันที ไม่ต้องพิมพ์เอง ไม่กลัวก๊อปผิด!

[ขั้นตอนที่ 4: ดูสรุปกำไรสุทธิ (P&L) & ออกใบหักภาษี 50 ทวิ]
• เลื่อนลงมาที่ส่วนตารางบัญชีและการเงิน หรือกดดูสรุปรายรับ-ต้นทุนทีมงาน-กำไรสุทธิประจำเดือน
• เมื่อต้องการออกใบหักภาษี ณ ที่จ่าย (3%) ให้ตากล้องหรือฟรีแลนซ์ กดปุ่มออก "ใบ 50 ทวิ" ระบบจะสร้างเอกสารมาตรฐานสรรพากร 1 หน้า A4 ให้พร้อมพิมพ์หรือเซฟ PDF ทันที!

================================================================================
 🔑 3. การทดลองใช้ฟรี 3 คิวงาน & วิธีใส่ License Key ปลดล็อกตลอดชีพ
================================================================================

1. สิทธิ์ทดลองใช้งานฟรี (Free Trial):
   • คุณสามารถใช้งานได้ครบทุกฟังก์ชัน 100% สูงสุด 3 คิวงานจริง โดยไม่ต้องเสียค่าใช้จ่าย
2. การปลดล็อกใช้งานไม่จำกัดตลอดชีพ (Lifetime License — 1,000 บาท ครั้งเดียวจบ):
   • คลิกที่ป้ายสถานะมุมขวาบน ("ทดลองใช้ฟรี" หรือ "ใส่คีย์ปลดล็อก")
   • กรอกรหัส License Key ของคุณ (รูปแบบ SF-XXXX-XXXX-XXXX-XXXX) และชื่อสตูดิโอ
   • กดปุ่ม "ยืนยันเปิดใช้งาน" -> ระบบจะปลดล็อกเป็นรุ่น Lifetime Edition ทันที ข้อมูลเดิมที่บันทึกไว้ไม่หาย!

================================================================================
 🛠️ 4. รวมปัญหาที่พบบ่อย และวิธีแก้ไข (Troubleshooting FAQ)
================================================================================

❓ ปัญหาที่ 1: ดับเบิลคลิกเปิดโปรแกรมแล้ว หน้าเว็บไม่เด้งขึ้นมาเอง ต้องทำอย่างไร?
✅ วิธีแก้:
   • ดูว่าหน้าต่าง Terminal (บน Mac) หรือหน้าต่างจอดำ (บน Windows) เปิดทำงานอยู่หรือไม่
   • หากเปิดอยู่ ให้เปิดโปรแกรมเว็บเบราว์เซอร์ (Google Chrome, Edge หรือ Safari) ขึ้นมาเอง
   • พิมพ์ในช่อง URL ด้านบนว่า:
     http://localhost:8000/admin
   • แล้วกด Enter จะเข้าสู่หน้าโปรแกรมได้ทันที (แนะนำให้กดรูปดาว Bookmark เก็บไว้ได้เลย)

❓ ปัญหาที่ 2: เปิดโปรแกรมแล้วแจ้งเตือนว่า "Port 8000 is already in use" (พอร์ตถูกใช้งานอยู่)
✅ วิธีแก้:
   • แปลว่าคุณเปิดโปรแกรม StudioFlow ค้างไว้แล้วก่อนหน้านี้!
   • ไม่ต้องกดเปิดซ้ำ ให้เปิดเบราว์เซอร์แล้วเข้าไปที่ http://localhost:8000/admin ได้เลย
   • หรือหากต้องการรีสตาร์ทโปรแกรมใหม่ ให้ปิดหน้าต่าง Terminal/จอดำอันเก่าก่อน แล้วค่อยดับเบิลคลิกเปิดใหม่

❓ ปัญหาที่ 3: ตอนสั่งบันทึกใบจองเป็น PDF มีขอบขาวเกิน หรือติดวันที่/URL ด้านบน-ล่างกระดาษ
✅ วิธีแก้:
   • ในหน้าต่างสั่งพิมพ์ (Print / Save as PDF) ของ Chrome หรือ Edge:
     1) ช่อง Destination (ปลายทาง): เลือก "Save as PDF" (บันทึกเป็น PDF)
     2) ช่อง Paper size (ขนาดกระดาษ): เลือก "A4"
     3) กดคลิก "More settings" (การตั้งค่าเพิ่มเติม):
        - ช่อง Margins (ระยะขอบ): เลือก "None" (ไม่มี) หรือ "Default"
        - ติ๊กถูก ✅ ช่อง "Background graphics" (กราฟิกพื้นหลัง) เพื่อให้สีทองและป้ายสถานะแสดงครบ
        - เอาติ๊กถูกออก ⬜ ช่อง "Headers and footers" (ส่วนหัวและส่วนท้าย) เพื่อไม่ให้มีวันที่และลิงก์ติดขอบกระดาษ
     4) เอกสารจะออกมาสวยงามคมชัดเต็ม 1 หน้า A4 เป๊ะ 100%!

❓ ปัญหาที่ 4: ข้อมูลลูกค้าและคิวงานเก็บไว้ที่ไหน? ถ้าจะสำรองข้อมูล (Backup) ทำอย่างไร?
✅ วิธีแก้:
   • ข้อมูลทั้งหมดถูกบันทึกอยู่ในโฟลเดอร์ `data/` ข้างในโฟลเดอร์โปรแกรม StudioFlow บนเครื่องของคุณเอง (ปลอดภัย 100% ไม่รั่วไหล)
   • วิธีสำรองข้อมูลที่ง่ายที่สุด:
     1) กดปุ่ม "Backup / Export ข้อมูล" ในหน้าโปรแกรม หรือ
     2) ก๊อปปี้โฟลเดอร์ `StudioFlow` ทั้งโฟลเดอร์เก็บไว้ใน Flash Drive, External Harddisk หรือ Google Drive / iCloud ได้เลย

❓ ปัญหาที่ 5: ต้องการเปลี่ยนคอมพิวเตอร์เครื่องใหม่ จะย้าย License Key และข้อมูลไปอย่างไร?
✅ วิธีแก้:
   • 1 License Key ใช้ได้ 1 เครื่อง แต่สามารถย้ายเครื่องได้ตลอดเวลา!
   • วิธีสลับเครื่อง:
     1) ในเครื่องเก่า: ไปที่เมนูตั้งค่า License แล้วกดปุ่ม "ปลดการเชื่อมต่อเครื่องนี้ (Deactivate)" (หรือทักแจ้งแอดมินให้รีเซ็ตเครื่องให้ได้ทันที)
     2) ก๊อปปี้โฟลเดอร์ `StudioFlow` (ที่มีโฟลเดอร์ `data/`) จากเครื่องเก่า ไปวางในเครื่องใหม่
     3) เปิดโปรแกรมในเครื่องใหม่ แล้วกรอก License Key เดิมเพื่อเปิดใช้งานได้เลย ข้อมูลคิวงานและบัญชีทั้งหมดจะตามมาครบ 100%!

❓ ปัญหาที่ 6: ครั้งแรกเปิดในที่ไม่มีอินเทอร์เน็ตแล้วโปรแกรมแจ้งว่าต้องเชื่อมต่อเน็ต?
✅ วิธีแก้:
   • หากคุณดาวน์โหลดไฟล์ชุดเล็ก (Web Portable 2.3 MB) ในการเปิดใช้งาน "ครั้งแรกสุด" ให้เชื่อมต่ออินเทอร์เน็ต (เช่น ฮอตสปอตมือถือ) ประมาณ 20 วินาที เพื่อให้ระบบดึงเอนจินลงเครื่องอัตโนมัติ หลังจากนั้นจะสามารถใช้งานแบบออฟไลน์ 100% ได้ตลอดไปแม้ไม่มีเน็ต!

================================================================================
 💬 ช่องทางติดต่อสอบถาม & บริการหลังการขาย (ดูแลตลอดการใช้งาน)
================================================================================
หากพบปัญหาในการติดตั้ง มีข้อสงสัย หรือต้องการสั่งซื้อ License Key (1,000 บาท ตลอดชีพ):

• 🌐 เว็บไซต์ทางการ: https://studioflow-4tj.pages.dev
• 📘 เพจ Facebook: StudioFlow ระบบคิวงานช่างภาพ
  👉 ลิงก์เพจ: https://www.facebook.com/studioflowos
• 💬 LINE Official: https://line.me/ti/p/kS1MJSEjpY
• 📞 โทรศัพท์ติดต่อด่วน: 062-362-5498 (คุณณัฐวุฒิ)
================================================================================
